lodash.clonedeep

What is lodash.clonedeep?

The lodash.clonedeep package is a module of the Lodash library that provides a deep cloning function. This function creates a deep copy of a value, meaning that it recursively clones every level of nested objects or arrays, ensuring that no references to the original objects are kept in the clone. This is particularly useful when you need to manipulate data without altering the original source.

What are lodash.clonedeep's main functionalities?

Deep cloning objects

This feature allows you to create a deep copy of an object, including all nested objects, without any shared references.

{"const _ = require('lodash.clonedeep');
const object = { a: 1, b: { c: 2 } };
const clonedObject = _.cloneDeep(object);
console.log(clonedObject); // { a: 1, b: { c: 2 } }
console.log(object === clonedObject); // false
console.log(object.b === clonedObject.b); // false"}

Deep cloning arrays

This feature allows you to create a deep copy of an array, including all nested arrays, without any shared references.

{"const _ = require('lodash.clonedeep');
const array = [1, [2, [3, [4]]]];
const clonedArray = _.cloneDeep(array);
console.log(clonedArray); // [1, [2, [3, [4]]]]
console.log(array === clonedArray); // false
console.log(array[1] === clonedArray[1]); // false"}

Other packages similar to lodash.clonedeep

clone

The 'clone' package offers deep cloning functionality similar to lodash.clonedeep. It supports cloning of complex objects like regexes, dates, and DOM nodes. However, it does not have the same performance optimizations and utility functions that lodash provides.

deep-copy

The 'deep-copy' package is another alternative that provides deep cloning capabilities. It is less popular and not as well-maintained as lodash.clonedeep, but it offers a straightforward deep cloning solution.

rfdc

The 'rfdc' (Really Fast Deep Clone) package is a fast, simple deep cloning library. It claims to be faster than lodash.clonedeep for certain use cases, particularly when cloning plain objects and arrays. However, it may not handle complex or custom object types as well as lodash.clonedeep.

README

lodash.clonedeep v3.0.2

The modern build of lodash’s _.cloneDeep exported as a Node.js/io.js module.

Installation

Using npm:

$ {sudo -H} npm i -g npm
$ npm i --save lodash.clonedeep

In Node.js/io.js:

var cloneDeep = require('lodash.clonedeep');

See the documentation or package source for more details.